Knowledge Archive
Summary · AI

个人助理部署-cc-connect+Claude Code+飞书QQ

AI 2026-05-18 · 5 min read · 0 backlinks
cc-connectClaude-Code飞书QQ-Bot个人助理MiniMax小米

个人助理部署:cc-connect + Claude Code + 飞书/QQ Bot

核心架构

text
飞书/QQ 消息 → cc-connect (tc-sv 常驻 daemon)
                   → Claude Code (mimo-v2.5 模型)
                       → 读取 AGENTS.md (个人助理规则)
                       → 执行任务
                   → 回复飞书/QQ

方案选择过程

方案结果原因
cc-connect + qoder❌ 空响应cc-connect 对 qoder stream-json 解析有 bug(issue #1047)
cc-connect + opencode❌ 空响应同上,cc-connect 通用 bug
cc-connect + claude code (MiniMax)✅ 正常cc-connect 原生支持 claude code 格式
cc-connect + claude code (小米 mimo-v2.5)✅ 正常最终方案,便宜

部署位置

tc-sv(腾讯云硅谷轻量服务器)

配置文件

~/.cc-connect/config.toml

toml
language = "zh"

[log]
level = "debug"

[\[projects\]]
name = "felix-assistant"

[projects.agent]
type = "claudecode"

[projects.agent.options]
work_dir = "/home/ubuntu/workspace"
mode = "default"

[\[projects.platforms\]]
type = "feishu"

[projects.platforms.options]
app_id = "cli_aa807ae5dff8dcbc"
app_secret = "***"

[\[projects.platforms\]]
type = "qqbot"

[projects.platforms.options]
app_id = "1904031885"
app_secret = "***"
sandbox = false
allow_from = "*"

~/.claude/settings.json

json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://token-plan-cn.xiaomimimo.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "***",
    "API_TIMEOUT_MS": "3000000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "ANTHROPIC_MODEL": "mimo-v2.5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "mimo-v2.5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "mimo-v2.5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "mimo-v2.5"
  }
}

~/.claude.json

json
{
  "hasCompletedOnboarding": true
}

/home/ubuntu/workspace/AGENTS.md

个人助理角色定义(95行):身份、能力边界、行为红线、分流规则、飞书交互规范。

运维命令

bash
cc-connect daemon status    # 查看状态
cc-connect daemon logs -f   # 实时日志
cc-connect daemon restart   # 重启
cc-connect daemon stop      # 停止
cc-connect daemon uninstall # 卸载

飞书配置要点

  • 飞书开放平台创建企业自建应用
  • 开启机器人能力
  • 订阅事件:im.message.receive_v1 + card.action.trigger
  • cc-connect feishu setup --project felix-assistant 完成绑定

QQ Bot 配置要点

  • QQ 开放平台(https://q.qq.com)创建机器人
  • 获取 AppID + AppSecret
  • 官方 API v2,WebSocket 连接,无需公网 IP
  • 群聊限制:仅 @机器人 时收到消息

已知问题

  1. cc-connect + qoder/opencode 空响应:GitHub issue #1047,等作者修复
  2. 飞书 card 模式:需订阅 card.action.trigger,否则报 200340 错误
  3. 模型名大小写:小米的模型名必须小写 mimo-v2.5,大写报 400

成本

  • mimo-v2.5:小米 token plan,比 Anthropic 官方便宜很多
  • tc-sv 服务器:已有,不额外增加成本
  • 飞书/QQ Bot:免费

关键概念

关联页面